home *** CD-ROM | disk | FTP | other *** search
/ LOGIC 2000 February / LogicCd--feb.2000-mac-cdr.iso / Apple II / SHRINKIT.V3.4 / README.AUTO < prev    next >
Encoding:
Text File  |  1990-10-23  |  5.3 KB  |  134 lines  |  [TEXT/pdos]
  1.  
  2. AUTO UnShrinkIt
  3. ---------------
  4.  
  5. This program is freeware.  Please distribute it, but you may NOT sell it
  6. without a license agreement explicitly allowing you to do so.  This includes
  7. bundling Auto-UnShrinkIt with any other products.
  8.  
  9. Questions, Comments, and Donations are welcome at:
  10.  
  11. Andy Nicholas
  12. 8415 Thornberry Drive East
  13. Upper Marlboro, MD   20772
  14.  
  15. America-Online & GEnie: shrinkit
  16. CompuServe: 70771,2615
  17.  
  18. Release Notes
  19. -------------
  20.  
  21. Version 1.0.1, 10/23/90 --
  22.  
  23. Fixed a minor bug which could sometimes change the output to inverse depending on how the current pathname was set.
  24.  
  25. Version 1.0, 10/13/90 --
  26.  
  27. This is the first version of auto-unshrink.  This is also a very simple program
  28. with a simple mission: extract stuff from archives which can be built on an
  29. Apple II using any Apple II which can run ProDOS.
  30.  
  31. If you launch auto-unshrink from a program launcher shell that provides a
  32. startup filename (such as launching from ECP-8 or Dave Lyons' Davex shell),
  33. then that archive will be opened and the contents extracted to the current
  34. prefix.
  35.  
  36. If you launch auto-unshrink from a program which does not supply a startup
  37. filename, then you will be told what the source folder (current prefix) is and
  38. be allowed to enter the name of the archive to open.  After you successfully
  39. enter the name of an archive to open, you will be prompted for the name of a
  40. folder to extract the contents of the archive INTO.
  41.  
  42. At any prompt except those asking for a filename, a 40 second timeout is in
  43. effect.  The default option in most cases for a YES/NO situation is YES, and
  44. for most cases where more than one choice is available, the default is chosen
  45. for you.
  46.  
  47. AUTO is capable of extracting the following types of archives:
  48.  
  49. NuFX (ShrinkIt)
  50. NuFX (ShrinkIt) inside a Binary II envelope.
  51. NuFX (ShrinkIt) inside MacBinary.
  52. NuFX (ShrinkIt) from America-Online.
  53. Binary II
  54. Binary II inside a Binary II envelope.
  55. Binary II inside MacBinary.
  56. ACU
  57. ACU inside a Binary II envelope.
  58. ACU inside MacBinary.
  59. SQ
  60.  
  61. NuFX from America-Online has a 32-byte header in front of the actual archive
  62. data if the archive was uploaded to America-Online from a Macintosh.
  63.  
  64. Scavenge
  65. --------
  66.  
  67. Q: What do I do if a disk which contains my most precious archive goes bad and
  68.    says it has bad blocks?
  69.  
  70. A: Copy the disk using a disk-copier which will ignore the bad blocks.  Then,
  71.    using Auto-UnShrink, try to extract the contents of the archive from the
  72.    good disk. 
  73.  
  74.    Auto-UnShrink will "scavenge" its way through the archive and pick out all
  75.    the stuff in the archive which is still good.
  76.  
  77. *****
  78.  
  79. Q: After I did that, I ran regular ShrinkIt on the archive and could not
  80.    extract everything from the archive.  I did the same for GS-ShrinkIt except
  81.    GSHK said that the archive was "Damaged."  Why can't I extract using the
  82.    regular programs?
  83.  
  84. A: ShrinkIt and GS-ShrinkIt do not have an archive scavenger built in like
  85.    Auto-UnShrink does.  ShrinkIt displays an asterisk beside the archive name
  86.    if the archive is damaged, while GS-ShrinkIt actually says "Damaged," but
  87.    can't really do anything about it (yet).
  88.  
  89. *****
  90.  
  91. If auto-unshrink finds a damaged entry in an archive, you will be given 3
  92. choices.  The first is S = Scavenge.  Scavenge works for shrinkit archive by
  93. searching from the end of the last header looking for the alternating ascii
  94. "NuFX" signature within the file.  If it finds one, it switches back into
  95. normal extraction mode.  If it never finds another good header or gets an EOF
  96. or position past EOF error, then the scavenger will say that it has reached
  97. the end of the archive without any success.
  98.  
  99. In the case of getting munged data when regular shrinkit would give the data
  100. corrupted $81 error, auto-unshrink will close the existing file, set the file's
  101. attributes as best it can, and then automatically enter scavenge mode, and
  102. begin scavenging from the end of the last good header.
  103.  
  104. The second option usually given is T = Try extracting.  Although this could
  105. lead to an amazing crash, I included it so that people could at least attempt
  106. to extract a file whose header might simply not even exist.
  107.  
  108. Scavenge also works for Binary II files.  If scavenge is ever kicked in, the
  109. search for a valid header begins from the end of the last known good header.
  110.  
  111. Scavenge will not work on ACU files.  The main reason for this is that the
  112. ACU file format is protected by a 16-bit CRC only.  This makes looking for
  113. valid headers amongst the data in the file extremely slow.  If someone
  114. really needs this feature, send me a lot of money and I'll add it.
  115.  
  116. Speech Support
  117. --------------
  118.  
  119. If you have an Echo or SlotBuster card, auto-unshrink will make use of the card
  120. and speak as it works.  If you have a Street Electronics Echo card, you must
  121. put the PT.OBJ file from Street's distribution disk into the same folder as
  122. auto-unshrink.  If you want the current Text-Talker software to be overwritten
  123. and Text-Talker reloaded (or just initialized for the first time), hold down
  124. the Open-Apple key on your Echo-equipped machine.  If you have previously run
  125. the Text-Talker software, Text-Talker will not be re-loaded from disk unless
  126. told to do so via the Open-Apple key.
  127.  
  128. If you have an Apple IIGS, you may need to set the system speed to slow.
  129.  
  130. At any prompt for a name, pressing Control-L (once) will read the contents of
  131. the name as it exists. Pressing Control-X will clear the filename and say that
  132. the name is empty.
  133.  
  134.